home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / BF_SDK11.ZIP / BF-SDK.TXT < prev    next >
Text File  |  1996-06-11  |  7KB  |  214 lines
  1.  
  2.  
  3.  
  4.  
  5.                    BF-SDK
  6.  
  7.  
  8.               Blowfish Software Development Kit
  9.  
  10.  
  11.                 Version 1.1
  12.  
  13.  
  14.            (c) 1996 Markus Hahn & Cedric Reinartz
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22. 1. Disclaimer
  23. ~~~~~~~~~~~~~
  24.  
  25. This software is "as it is" .
  26. The makers and developers of this package make no representation, warranty,
  27. assurance or inducement, express or implied, as to its adequacy, sufficiency
  28. or freedom from defect of any kind. Neither the makers or developers will
  29. have any liability to any user resulting from the use of it nor are they
  30. responsible for any data loss or computer failure resulting from any inherent
  31. incompatibilities with any other software or hardware.
  32.  
  33.  
  34.  
  35.  
  36. 2. Introduction
  37. ~~~~~~~~~~~~~~~
  38.  
  39. This is the Blowfish System Development Kit.
  40. It provides the basic functions to en-/decrypt data in ECB and CBC mode.
  41. You can directly use it in Turbo/Borland Pascal, TASM/MASM and even
  42. in MS Visual C++. Interfaces for other languages like Fortran or Cobol
  43. are easy to implement.
  44. To learn how Blowfish works, read BFCBCGR.TXT. Unfortunately it's only
  45. in German (too less time), but you should be able to understand the
  46. functionality of the BF-SDK easily by studying the examples in assembly,
  47. Pascal or C++.
  48.  
  49. If you want to know more about Blowfish, data encryption and security, please
  50. read
  51.     "Applied Cryptography, 2nd Edition" by Bruce Schneier
  52.             ISBN 0-472-11709-9
  53.  
  54. Just send an e-mail to Bruce (schneier@counterpane.com) to get an 15% discount.
  55.  
  56. To learn how to use the provided sources read PASCAL.TXT for the Turbo-
  57. Pascal part, ASM.TXT for the assembly part and CPPTXT for the C++ part.
  58.  
  59. We're interested in any feedback! If you have any questions, suggestions or
  60. improvements, please leave us an e-mail.
  61.  
  62.  
  63.  
  64.  
  65. 3. Files in this package
  66. ~~~~~~~~~~~~~~~~~~~~~~~~
  67.  
  68. sourcecode:    BFENG386.ASM    the engine, the heart of all
  69.         BFE_ASM.INC    macros to help in writing assembly apps
  70.         BLOWFISH.PAS    Pascal unit interface
  71.  
  72.         BLOWFISH.H    needed for C implementations
  73.         CPP_DEMO.CPP    demo written in MS Visual C++
  74.  
  75.         ASM_DEMO.ASM    demo written in assembly language
  76.         PAS_DEMO.PAS    demo written in Pascal
  77.  
  78.  
  79. precompiled:    BFENG386.OBJ    object file of the cryptengine
  80.                 BLOWFISH.TPU    Borland Pascal Unit
  81.         ASM_DEMO.EXE    assembly demo executable
  82.         PAS_DEMO.EXE    Pascal demo executable
  83.         CPP_DEMO.EXE    QuickWin demo for Windows 3.x (and above)
  84.  
  85.  
  86. documentation:    BF-SDK.TXT    you're reading this now
  87.                 BFCBCGR.TXT     explanation of Blowfish (german only, sorry)
  88.  
  89.                 ASM.TXT         explanation on how to use BF-SDK in Assembler
  90.                 CPP.TXT         explanation on how to use BF-SDK in C++
  91.                 PASCAL.TXT      explanation on how to use BF-SDK in Pascal
  92.  
  93. misc:           MAKEALL.BAT     batch file which compiles all the precompiled
  94.                                 from the source, except of the MSVC project
  95.                 FILE_ID.DIZ     BBS description
  96.  
  97.  
  98.  
  99. 4. Technical Notes
  100. ~~~~~~~~~~~~~~~~~~
  101.  
  102. This software needs at least:
  103.  
  104.   -  IBM compatible AT-system with an 80386SX processor or better
  105.   -  DOS 3.0 or above
  106.  
  107. achieved speed:    1.8 MB/sec on a Pentium90
  108.                    2.7 MB/sec on a Pentium133
  109.  
  110. The actual version (1.1) is designed for 16bit systems, so you
  111. should be able to use it in every - DOS real mode application
  112.                                   - DOS 286 protected mode application
  113.                                   - Windows 3.x application flawlessly.
  114.  
  115.  
  116.  
  117. 5. Copyrights
  118. ~~~~~~~~~~~~~
  119.  
  120. Blowfish is a data encryption algorithm which was published in the Dr.Dobb's
  121. Journal magazine, issue #213 on April 1994. It was developed by Bruce Schneier
  122. and is unpatented and placed in the public domain.
  123. In the September issue 1995 of DDJ Blowfish was (after a sponsored contest)
  124. still unbreaked.
  125. The advantages of this encryption algorithm is its design for 32bit CPUs like
  126. the 80386 and above achieving an excellent performance with a maximum
  127. gain of security.
  128.  
  129. The Blowfish implementation used in this software was done by:
  130.  
  131.            Markus Hahn
  132.            Schellingstrasse 13
  133.            72622 Nuertingen
  134.                Germany
  135.                e-mail: hahn@pcmail.rz.fht-esslingen.de
  136. and
  137.                Cedric Reinartz
  138.            Schumannstrasse 51
  139.            40822 Mettmann
  140.            Germany
  141.                e-mail: cer@servww4.ww.uni-erlangen.de (till end of 1996)
  142.  
  143.  
  144.  
  145.  
  146. 6. Distribution and usage limits
  147. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  148.  
  149. The BF-SDK can be distributed freely if:
  150.  
  151.    - all files are distributed together
  152.    - all files are unmodified
  153.    - no fee (excluding material and shipping costs) is taken
  154.  
  155. If you use BF-SDK 1.1 for your own private purpose or if you developed
  156. a program which is totally free and not bundled with a non-free product,
  157. you can do so without paying any money (to us or someone else).
  158.  
  159. For any other use (especially profit use) you have to contact Markus Hahn
  160. and Cedric Reinartz.
  161.  
  162. In any case you have to:
  163.  
  164.    - write a program documentation which contains the whole Copyright
  165.      statement (part 5) from this text.
  166.    - send us (both) a note that you are using it!
  167.  
  168.  
  169.  
  170.  
  171. 7. The real world
  172. ~~~~~~~~~~~~~~~~~
  173.  
  174.    The BF-SDK is used in the following products:
  175.  
  176.  
  177.         * ASPICRYP by Cedric Reinartz, a DOS based TSR which hooks to an
  178.           ASPI-Manager and encrypts the data going to a SCSI-device using the
  179.           Blowfish algorithm in CBC mode.
  180.           You can get it at:
  181.                                      ftp.franken.de
  182.                                      /pub/crypt/misc/ASPICRxx.ZIP
  183.  
  184.                                      ftp.garbo.uwasa.fi
  185.                                      /pub/crypt/ASPICRxx.ZIP
  186.  
  187.         * Blowfish Advanced 7 (BFA7) by Markus Hahn
  188.           a fast, secure and comfortable file encryption utility
  189.           for 386+ and DOS. It'll soon be available for Windows 95, too.
  190.           You can get it at:
  191.                                      ftp.uni-stuttgart.de
  192.                                      /pub/systems/pc/security/BFA7xx.ZIP
  193.  
  194.                                      ftp.garbo.uwasa.fi
  195.                                      /pub/crypt/BFA7xx.ZIP
  196.  
  197.  
  198.  
  199.  
  200. 8. The Future
  201. ~~~~~~~~~~~~~
  202.  
  203.    It would be nice to have some CFB routines, which allows Blowfish
  204.    to work as a stream cipher, encrypting and decrypting single bytes,
  205.    although the performance will be decreased to about 12% of the
  206.    original one.
  207.    If you want to contribute something, send it to Cedric Reinartz
  208.    or Markus Hahn.
  209.  
  210.  
  211. - end of document -
  212.  
  213.  
  214.